home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_leafnode.idb / usr / freeware / catman / a_man / cat8 / fetch.Z / fetch
Encoding:
Text File  |  1999-04-16  |  7.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      ffffeeeettttcccchhhh((((8888))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22221111 NNNNoooovvvv 1111999999998888))))          ffffeeeettttcccchhhh((((8888))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       fetch    - fetch    news via NNTP
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ffffeeeettttcccchhhh    [[[[----vvvv]]]] [[[[----xxxx nnnnuuuummmmbbbbeeeerrrr]]]] [[[[----llll]]]] [[[[----nnnn]]]]
  14.  
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       LLLLeeeeaaaaffffnnnnooooddddeeee is a    USENET package intended    for small sites, where
  18.       there    are few    users and little disk space, but where a large
  19.       number of groups is desired.
  20.  
  21.       The design of    lllleeeeaaaaffffnnnnooooddddeeee is intended to    self-repair after
  22.       problems, and    to require no manual maintenance.
  23.  
  24.       FFFFeeeettttcccchhhh    is the program which submits and retrieves new
  25.       articles to or from the upstream NNTP    server.
  26.  
  27.  
  28.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  29.       -_v   Be verbose.  A maximum of four -_v can be    used (the more
  30.            v, the more verbose):
  31.  
  32.       -_v   Warn about non-critical errors.
  33.  
  34.       -_v_v  Be verbose whenever a group command occurs.
  35.  
  36.       -_v_v_v Be verbose whenever an article command occurs.
  37.  
  38.       -_v_v_v_v
  39.            For debugging purposes. Don't expect the    additional
  40.            output to make sense.
  41.  
  42.       -_x _n_u_m_b_e_r
  43.            Go _n_u_m_b_e_r articles back and try to re-fetch what's
  44.            missing.    Chiefly    used for debugging purposes.
  45.  
  46.       -_l   Don't use supplementary servers ( -_l is supposed    to
  47.            mean "local"). This does    speed up the operation quite a
  48.            bit.
  49.  
  50.       -_n   Don't unlink files in the _i_n_t_e_r_e_s_t_i_n_g._g_r_o_u_p_s directory.
  51.            This avoids automatic unsubscription of newsgroups.
  52.  
  53.       -_f   Force rereading of whole    active file from all upstream
  54.            servers.    This is    usually    occurring only very
  55.            infrequently because it takes a long time.
  56.  
  57.       -_P   Only post articles that have accumulated    in the
  58.            _o_u_t._g_o_i_n_g directory but do not fetch articles from
  59.            upstream    servers.
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 3/1/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ffffeeeettttcccchhhh((((8888))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22221111 NNNNoooovvvv 1111999999998888))))          ffffeeeettttcccchhhh((((8888))))
  71.  
  72.  
  73.  
  74.      FFFFIIIILLLLEEEESSSS AAAANNNNDDDD CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN
  75.       See lllleeeeaaaaffffnnnnooooddddeeee(8) for the list of files    affected, and for
  76.       information on configuring ffffeeeettttcccchhhh....
  77.  
  78.  
  79.      AAAALLLLGGGGOOOORRRRIIIITTTTHHHHMMMM
  80.       Here is a brief description of what ffffeeeettttcccchhhh does.
  81.  
  82.       First, after connecting to the upstream NNTP server, all
  83.       articles in /_v_a_r/_s_p_o_o_l/_n_e_w_s/_o_u_t._g_o_i_n_g    are posted using POST.
  84.       If a posting fails, that article is moved to
  85.       /_v_a_r/_s_p_o_o_l/_n_e_w_s/_f_a_i_l_e_d._p_o_s_t_i_n_g_s which    an administrator has
  86.       to clean up once in a    while.    Moving a file back to
  87.       /_v_a_r/_s_p_o_o_l/_n_e_w_s/_o_u_t._g_o_i_n_g is sufficient to resubmit it.
  88.  
  89.       Second, the upstream server's    list of    newsgroups (obtained
  90.       using    LIST ACTIVE and    LIST NEWSGROUPS) is merged into
  91.       lllleeeeaaaaffffnnnnooooddddeeee's (this step    is most    often optimized    away).
  92.  
  93.       Third, ffffeeeettttcccchhhh iterates    over the list of newsgroups,
  94.       performing a GROUP, an XHDR Message-ID and a number of HEAD
  95.       and BODY commands for    each group which has been read
  96.       recently.
  97.  
  98.  
  99.      NNNNOOOOTTTTEEEESSSS
  100.       FFFFeeeettttcccchhhh    does not use NEWNEWS or    XOVER.    NEWNEWS    is not used
  101.       because it is    often very expensive, XOVER is not used
  102.       because the information it obtains is    also present in    the
  103.       article headers.
  104.  
  105.       After    some experiments, I decided that it was    better to
  106.       fetch    all the    articles in a group than to optimize away
  107.       some;    users would complain too loudly    when the optmizer
  108.       guessed wrongly.  LLLLeeeeaaaaffffnnnnooooddddeeee is    not intended to    be all things
  109.       to all men, and I have sacrificed the    ability    to read    news
  110.       from two upstream servers.  (There is    some support for it,
  111.       but it is incomplete and undocumented    at the time of
  112.       writing.)
  113.  
  114.       FFFFeeeettttcccchhhh    happens    to support local groups, even though the rest
  115.       of lllleeeeaaaaffffnnnnooooddddeeee doesn't.
  116.  
  117.       The only way to control what newsgroups are accessible to
  118.       local    users is to control what the upstream server lets
  119.       ffffeeeettttcccchhhh    read, and that will not    keep out all crossposts
  120.       (endemic in e.g. the alt.sex groups).     If your site is big
  121.       enough that you need to control newsgroup access, consider
  122.       using    a news server which is designed    for a big site.
  123.  
  124.       FFFFeeeettttcccchhhh    sets its real and effective uid    to "news", because
  125.       almost all of    the problems I have had    with lllleeeeaaaaffffnnnnooooddddeeee are due
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 3/1/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ffffeeeettttcccchhhh((((8888))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22221111 NNNNoooovvvv 1111999999998888))))          ffffeeeettttcccchhhh((((8888))))
  137.  
  138.  
  139.  
  140.       to files which aren't    writable for user news.
  141.  
  142.  
  143.      BBBBUUUUGGGGSSSS
  144.       FFFFeeeettttcccchhhh    ignores    the "Supersedes" and "Also-Cancel" headers.
  145.       This needs to    be fixed, or news.answers will suffer.
  146.  
  147.       Never    deletes    a group    from the list of active    newgroups.
  148.  
  149.  
  150.      AAAAUUUUTTTTHHHHOOOORRRR
  151.       Written by Arnt Gulbrandsen <agulbra@troll.no> and copyright
  152.       1995-96 Troll    Tech AS, Postboks 6133 Etterstad, 0602 Oslo,
  153.       Norway, fax +47 22646949.
  154.  
  155.       Modified by Cornelius    Krasel <krasel@wpxx02.toxi.uni-
  156.       wuerzburg.de>, Markus    Enzenberger <enz@cip.physik.uni-
  157.       muenchen.de> and Randolf Skerka <Randolf.Skerka@gmx.de>.
  158.       Copyright of the modifications 1997-1999.
  159.  
  160.  
  161.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  162.       ttttccccppppdddd(8), hhhhoooossssttttssss....aaaalllllllloooowwww(5), lllleeeeaaaaffffnnnnooooddddeeee(8),    tttteeeexxxxppppiiiirrrreeee(8), RRRRFFFFCCCC    999977777777
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 3/1/99)
  196.  
  197.  
  198.  
  199.